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PREFACE 


The operation and use of the EDIT/EDITVP/EDITVT XVM Utility program 


(EDIT) are described in this manual. 


It was assumed in the preparation of this manual that the reader is 
familiar with the operation of the XVM or PDP-15 equipment and the 
contents of the software manual describing the features of XVM/DOS 


(XVM/DOS Software System User's Manual). 


This manual also serves as complementary documentation for the 
XVM/RSX EDITOR. However, the description of DAT slots given in this 
manual does not apply to the XVM/RSX EDITOR. 
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CHAPTER 1 
INTRODUCTION 


The EDIT/EDITVP/EDITVT XVM Utility program is a powerful context- 
editing program that allows the modification and creation of symbolic 
source programs and other ASCII text material?. By means of keyboard 
commands, the Editor is directed to bring a line, or group of lines, 
from the input file to an internal buffer. The user can then, by 
means of additional commands, examine, delete, and change the contents 
of the buffer, and insert new text at any point in the buffer. When 
the line or block of lines has been edited, it is written into a new 
file on the output device. 


The Editor is most frequently used to modify MACRO and FORTRAN IV 
source programs, but it can also be used to edit any symbolic text. 


The EDIT program operates with the Disk Operating (XVM/DOS) Software 
System. Two versions of the EDIT program designed to use available 
CRT display systems for soft-copy display purposes during EDIT opera- 
tions are described in Appendices B and C. 


Appendix B contains a description of the use of EDITVP, an editor 
program which utilizes the VP15A Storage Tube Display unit as the 
editing data display device instead of the console printer. 


Appendix C contains a description of the use of EDITVT, an editor 
program which utilizes the VT15 Graphic Display Unit as the editing 
display device instead of the console printer. 


lfhe Editor reads and writes standard IOPS ASCII lines. The charac- 
teristics of IOPS ASCII text are described in the XVM/DOS User's 
Manual. 


Introduction 


A summary of the standard Editor commands is presented in Appendix A. 


Special symbols, when used in this manual, are defined 


Symbols 


a! 
-+| 


— 


{] 


Represents 
Carriage RETURN-LINE FEED operation 
TAB 


SPACE 
Optional Command String elements 


as follows: 


CHAPTER 2 
FUNCTIONAL DESCRIPTION 


2.1 CONTROL MODES 


The Editor operates in either an EDIT or INPUT control mode. In the 
EDIT (or command) Mode, the program accepts and acts upon control word 
and data strings to open and close files; to bring lines of text from 
an open file into the work area; to change, delete, or replace the 
line currently in the work area; and to insert single or multiple 
lines after the line in the work area. In Input (or Text) Mode, lines 
from the keyboard are interpreted as text to be added to the open 
file. Commands are available for conveniently changing control mode. 


2.2 DATA MODES 


Data from the input file is made available for editing in two ways: 
in Line-by~Line Mode or in Block Mode. 


The Line-by-Line data mode is the program "default" mode if both the 
input and output devices are directoried devices. If either or both 
of the devices involved are non-directoried, the program default is 
the Block Mode. 


2.2.1 Line-by-Line Data Mode 


In Line-by-Line Data Mode, a single line is the unit of the input file 
available to the user for modification at any point. The line cur- 
rently available is specified by a pointer, which can be thought of 

as moving sequentially through the file, starting just before the 
first file line, in response to typed editing commands. When a file 
is opened at the beginning of an editing session, the first line of 
that file can be brought into the work area and is available for 


modification. This line remains in the work area until the user 


Functional Description 


requests that a new line be brought in. The pointer then moves down 
the file until the line requested is encountered. That line is 
brought to the work area and, as the "current" line, can be modified. 
Lines previously skipped over are no longer available for editing by 
the user, but are written in the output file. Thus, at any point in 
a sinale edit run in Line-by-Line mode, the user is able to modify 
only the portion of the input file consisting of the current line and 
all lines between the current line and the end of the file (i.e., the 
current line and all lines below it). 


2.2.2 Block Data Mode ake 


In Block Data Mode, a user-specified portion? 


of the input file is — 
held in a core buffer for editing until the user requests that the 

contents of the buffer be added to the output file. A group of Editor ae 
commands is available for use in Block Mode only (see Section 4) in 


addition to the commands used in line-by-line editing. 


When the user is operating in Block Mode, commands to the Editor are 
honored only with respect to that portion of the input file currently 
occupying the buffer. The lines of text in the buffer are made 
available for modification through the use of normal locative requests 
and can be reaccessed until the buffer is emptied by the user. 


Unless deleted, lines passed over in Block Mode are available to the 

user until the contents of the buffer are written in the output file. 

Consider, for example, the editing request to search for and bring in 

a specified line. [In Line-by-Line Mode, the result is a scan of ——, 
(possibly) the entire file below the pointer. The same request in 

Block Mode provides a search of the entire buffer below the pointer, 


but no further. 


Block Mode has another advantage: rapid correction of editing command 
errors. If the user finds that he has typed the wrong command, he 

can immediately correct it, because the buffer has not been added to 
the output file. In Line-by-Line Mode, a command error may cause the 
program to bypass a line in which a change is needed. The user must 
then output a new input file and begin editing again (i.e., via the 


TOP (T) command). 


a 





lITf not specified, a group of 5549 lines is assumed (default size) 
by the Editor. 
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Figure 2-1 
Schematic of Line Processing in 
Block and Normal Modes 


2.3 DATA FILES 


The following paragraphs describe the XVM/DOS I/O features utilized 
by the Editor program, how data may be added to files and the opera- 


tions performed on the Editor output files. 
2.3.1 Using Monitor I/O 


In the XVM/DOS software environment, the Editor makes use of the 
monitor's Input/Output Programming System (IOPS) for I/O transfer 
operations. The Editor communicates with IOPS via separate Device 
Assignment (DAT) and User File Directory (UFDT) tables. Refer to 

the XVM/DOS User's Manual for a description of these tables and their 


use. 


Functional Description 


Table 2-1 
Standard DAT and UFDT Slot Assignments for the XVM/DOS Monitor 


Output/Scratch 
I/O 


Secondary Output 
Listing Output 
Secondary Input 
(EDITVP only) 





The tables involved are provided with a set of standard "slot" device 


and UIC assignments (shown in Table 2-1). These assignments may be _ 
altered for an editing operation by using the monitor ASSIGN command, 

prior to loading the Editor program, to change the table assignments 

as desired. 

2.3.2 Input and Subsidiary Files 

The Editor accepts inputs from: — 


a) the console keyboard (i.e., commands and text entries), 


b) a file input device/UFD which contains the file to be 
edited (.DAT -14), 


c) a subsidiary input device/UFD which contains, normally, 
prepared material to be inserted into the object file 
(.DAT -10). 


If the file input and subsidiary inputs are ignored (not assigned) by 
the user, the Editor assumes that all inputs will come from the key- 


board. 


The subsidiary input device may be either directoried or non-direc- 
toried. When the GET command is typed, the Editor issues a .FSTAT to 
.DAT -10. If the device is directoried, the entire contents of the 
file named in the GET command is inserted into the output file. If, 


"n" lines will be inserted 


however, the device is non-directoried, 


into the file. 


IThe current UIC will be given here, GEP is an example. 


Functional Description 


2.3.3 Output Files 


The Editor, upon receiving control, attempts to determine if the input 
and scratch devices are directoried. If either one of the devices is 
not directoried, then the scratch device (.DAT -15) is assigned as 

the final output device. If both devices are directoried, the scratch 
device is assigned an intermediate function and the input device is 


used as the final output device. 


If, in XVM/DOS editing operations, the same device and UIC are speci- 
fied as both the input and output devices, then the file CLOSE opera- 


tion will cause the edited file to be renamed, not recopied. 


The intent, in all cases, is to allow replacement of the input file 

by the edited output file. This is possible only when the input and 
output devices can be both read and written. If replacement can be 

accomplished (both devices are directoried), the following sequence 

of events takes place when the files are closed after editing. 


a. The intermediate output file is read from the scratch 
device and written on the input device under a temporary 
name. 


b. The old input file is deleted from the input device. 


c. The intermediate output file is deleted from the scratch 
device. 


d. The intermediate output file, temporarily named and now 
residing on the input device, is given the name previously 
assigned to the old (now deleted) input file. 


e. The output file is closed and immediately becomes 
available for use. 


If no replacement can be accomplished, no change is ever made to the 
input file. If the output device is directoried, the newly edited 
file is properly entered in the file directory for that device under 
the name given in the OPEN, CLOSE, or EXIT command sequences. 


The possible destinations of the new edited file are summarized in 


Table 2-2. 


Note that in the process of file housekeeping, there is always at 
least one copy of the output file available on one, or both, of the 
devices. Further, the original input file is not deleted until 


Functional Description 


the new file has been successfully written and closed. A system 


failure, therefore, can never result in total loss of data. 


Table 2-2 
Output File Conventions for the Text Editor 


Scratch or Edited File 
Input Device Output Device Appears on: Input File is: 


Directoried Directoried Input Device | Deleted 


Directoried Non-directoried Output Device Unchanged 
Non-directoried Directoried Output Device Unchanged 


Non-directoried Non-directoried Output Device Unchanged 





In addition, it is possible, through use of the PUT and PCLOSE 
commands, to create alternate output files which will reside on the 
device assigned to .DAT -13. The use of these commands is discussed 


fully in Sections 4.2.4 and 4.6.2, respectively. 
2.4 USE OF THE CTRL P KEYBOARD COMMAND 
The command CTRL P when: 


a) issued during the entry of a command string (before 
terminator) causes the Editor to be restarted. 


b) issued during the process initiated by a command string, 
aborts the process on completion of the current logical 
sequence (ignored during MOVE command operations) ; 


c) issued during an INPUT mode, causes all data entered on 
the current line to be deleted and switches the mode to 
EDIT. A second CTRL P entry at this time would restart 
the Editor. 


2.5 CHARACTER ERASE AND LINE DELETE KEYBOARD COMMANDS 


Two keyboard commands are provided the user which permit the 
deletion (erasure) of individual characters of a line and the 


deletion of a line or line segment. The command: 


a) RUBOUT, permits the deletion of individual characters. 
Each operation of the keyboard RUBOUT key deletes the 
last entered (non-erased) character of the current line. 
The symbol (\) is echoed on the console printer each 
time RUBOUT is used. The following illustrates the 
RUBOUT operation: 


b) 


Functional Description 


(SSS S= 5 
i neat aca i 
yyy qi! 
A BeCé~p EA \\\ results in the line >A 
entered RUBOUTS 
characters 


CTRL U causes the deletion from the current line of all 
characters entered before the CTRL U was issued. Each 
CTRL U entry causes the symbol (@) to be echoed at the 
console printer. The following illustrates the CTRL U 
Operation. Note that the > is a prompting symbol printed 
by the Editor and not typed by the user. 


Deletes inputs entered before @ 
7 ABCDE@FGH ey 

results in a final line of 
> FGE 7, 


During editorial operations, neither the RUBOUT nor 
CTRL U command affects previously prepared text. 


NOTE 


In addition to its editorial function, CTRL U 

may also be keyed in to terminate Editor output 
of the current teleprinter line. Entered at 

any time during a teleprinter output operation, 
CTRL U immediately terminates the operation and 
initiates a Carriage RETURN. This might be 
useful following a command to PRINT several lines 
of text when it is not known exactly where the 


information sought begins. 


a 


CHAPTER 3 
EDITING OPERATIONS 


The Editor always begins in the EDIT mode and assumes that the user 
wishes to modify some (named or unnamed) file. When first loaded or 
restarted, the EDITOR program outputs the message: 

EDITOR XVM Vnxnnn 
where: 

nx = a version number 
and 

nnn = an edit number 
at the console printer and waits for the user's first command. 


3.1 MODIFYING AN EXISTING FILE 


If the input device has a directory (disk, magnetic tape, or DECtape), 
the first command to the Editor must be: 


OPEN filename ext «/ 
where "filename" is the primary name! of the wanted file residing on 
the input device and "ext" is its extension?. Ext can be omitted 


and, if so, is assumed to be SRC. If the file specified is not found 
in the directory, the program assumes that the user wishes to create 


1Maximum of six characters permitted for "filename". 
?Maximum of three characters permitted for "ext". 


3-1, 


Editing Operations 


a file named "filename ext". Accordingly, when it has been determined 
that the named file is absent from the input device, the Editor types: 


FILE filename ext NOT FOUND. 
INPUT 


INPUT mode is entered and subsequent lines from the keyboard are 
inserted in a new temporarily named file on the output device. 


If the specified file is present on the input device, an intermediate 
temporarily named file is opened for writing on the output device, and 
the input file is opened for reading. The user may then proceed to 
make the necessary changes in the input file. 


If the input device is not directoried (e.g., paper tape reader, card 
reader), the user's first command after program initialization can be 
any edit request. The OPEN command is not required for non-directoried 
devices. 


3.2 INPUT/EDIT MODES 


To enter text from the keyboard, the Editor must be in INPUT mode. To 
carry out an edit function on the current line, the Editor must be in 
EDIT mode. 


Control may be changed at any time with a line of zero length (typing 
a Carriage RETURN or ALT MODE only). The Editor command INSERT 
(without arguments) also causes a mode change. After the user changes 
control modes, the Editor types INPUT or EDIT, indicating the control 
mode in effect. 


3.3 CREATING A NEW FILE 


When both input and output devices are directoried, the user can 
issue in EDIT mode the OPEN command, followed by the name he wishes 
to assign to his new file. Since a file of the name given is 
guaranteed not to be found (if the user has properly chosen his new 
name), INPUT Mode is immediately entered, following the standard 
error message. The name specified is assigned to the final output 


file if no other name is given in the CLOSE command. 


Editing Operations 


If the output device is directoried, a temporarily named file is 
opened for writing; input lines from the keyboard are added to it as 
they are entered. If the output device is not directoried, the file- 


naming conventions may be bypassed. 
3.4 EDIT BLOCK MODE 


If the BLOCK mode is not the current Editor default mode (refer to 
Section 2.2), the user must enter the keyboard command BLOCK ON to 
establish this data mode. 


During Block mode edit operations, the input file is edited in multi- 
line groups rather than line-by-line. Each group of lines is read 

into a Block buffer where edit operations are performed. On completion 
of the edit operations, the contents of the block buffer are written 
into an output file. The number of lines within each buffer group 

may be specified by the user by means of a SIZE command (see Section 
4.2.5). If not specified, the Editor assumes a default size of 35) 


0 
lines. 


To return to a line-by-line Edit Mode, the user must issue a BLOCK 
OFF command. If the BLOCK OFF command is issued before the Block 
Buffer is empty, the Editor outputs the message: 


BUFFER NON-EMPTY 
at the console printer. The user must then empty the buffer before 
the Block Edit Mode can be terminated. Block buffers are emptied 
using the command WRITE (refer to Section 4.3.2). 
3.5 CLOSING THE NEW FILE 
When the user, after modifying or entering an input file, is satisfied 
that all needed operations have been carried out, he must close out 
the input and output files using the edit command: 

erege. vil lenemecacet a 
which initiates the sequence of events described in Section 2.3.3. 
Neither "filename" nor "ext" need be specified if previously given 


in the OPEN command. Any filename and ext given in the CLOSE command 


string, override the names given in the OPEN command. 
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Editing Operations 


3.6 ERROR-HANDLING CONVENTIONS 
3.6.1 Command String Errors 


All mistakes in the use of Edit mode control words, result ina 
common complaint by the Editor. Although the possible errors in 
usage fall into a number of distinct categories, the program makes 
no attempt to differentiate among error types. The reasons for this 
common treatment lie in the requirement that the Editor take some 
cognizance of its memory allocation (relatively obscure error types 
need as much memory for recognition and response as do the more 
usual mistakes) and in the fact that the treatment rendered makes 


the error self-explanatory. 
Command string errors, then, all result in the single typed comment, 
NOT A REQUEST: 


followed, on the next line, by the request line with which the —, 
Editor had trouble. 


Usual types of command string errors include the following: 


a. The edit control word issued was not among those in the 
program's repertoire. 


b. A SIZE command was issued with a missing argument or an 
argument of "1". 


c. A command was issued in an illogical place, OPEN 
following an OPEN command. 


When the BRIEF Mode (see Section 4.2.8) is ON, the Editor command and 
the command line in error are replaced by a single typed question 


mark: 
fas 
3.6.2 Premature End-of-File 
During the processing of some commands, it occasionally happens that 


a read is attempted which moves the pointer below the last line of a 
logical (or physical) group. Consider, for example, the effect of a 


Editing Operations 


numeric argument in the GET n command line. The program reads 
successive lines from the subsidiary input device until exactly n 
lines have been read. If, in the process of reading, it is discovered 
that fewer than n lines are physically present on the secondary input 
medium (paper tape, say), then a premature end-of-file condition is 
said to exist. An improperly formulated FIND request (the character 


string typed is absent from the file) results in a similar condition. 


Depending on the character of the incoming group of lines (block 
buffer, secondary input medium, or input file), the appearance of 

an unexpected end-of-file causes a comment to be typed to inform the 
user of the difficulty. The form of the message is: 


BUFFER 


FILE REACHED BY: 


END OF 


followed, on the next line, by the edit request which caused the 
problem. 


A premature end-of-file causes the pointer to be left below the final 
line of the group being read. 


3.6.3 Read Errors and Line Overflow 


During DOS and RSX editing operations, inputs from either the input or 
subsidiary file are checked for two possible errors. Whenever a 

line containing an error is found, it is printed at the console and 
made the "current line" to enable it to be modified by the user. 

The first type of error occurs when the input file device handler 
detects either incorrect parity or a faulty checksum in the incoming 


line. The printed comment is: 
READ ERROR: 
followed by the line in which the error was encountered. 


The second difficulty results from the appearance of a line which is 
too long to be contained in the program's internal buffers. Any line 


Editing Operations 


of more than 13549 characters plus a terminator (DOS) or 80 


characters plus a terminator (RSX) results in the comment: 


10 


TRUNCATED: 


followed by the first (leftmost) 135 (or 80, 4) characters of the long 
line. The remaining right-end characters are discarded. The user has 
the choice, after either type of error, of modifying the line which 
causes the complaint (via any manipulative request) or of allowing 

the line to stand as is in the output file (via any locative request). 


3.6.4 Block Mode Buffer Overflow 


When Block Mode is in effect, it is possible for an attempted addition 
of a line to the Block Mode Buffer to exceed the buffer's capacity. 
This might occur, for example, during the processing of a READ request 
if the number of input lines (previously defined by a SIZE command) 
is too great to be accommodated by the memory available. When the 
capacity of the buffer is exceeded, the program types the comment: 


BUFFER CAPACITY EXCEEDED BY: 
(offending line) 


To eliminate this error condition, the operator must delete the 
excess (offending) line. The user should control carefully the size 
specification of the buffer and lines entered to ensure that this 


error condition is avoided. 
3.6.5 File Naming and Calling Errors 


Errors in file name usage can be classified in three general groups: 
1) either the named file cannot be found, 2) a name has not been 
given to the file at a point where one is needed, or 3) a name has 


been given which cannot be used. 

3.6.5.1 Absent File - If the file named in the OPEN request line 
cannot be found on the device associated with .DAT slot -14, the 
assumption is made that the user wishes to create a new file with the 
name given. The program prints the comment: 


FILE [filename ext] NOT FOUND. 


and changes to input mode. 
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3.6.5.2 Absent File Name - If no file name is given either in an 
OPEN request line or as an argument to the CLOSE command, the 
program, after attempting to process the CLOSE request, prints: 


NO FILE NAME GIVEN. 
The next edit request must be another CLOSE naming the file. 


If no OPEN command is issued (a new file is being created), any loca- 
tive request (FIND, NEXT) results in the comment: 


NO INPUT FILE PRESENT. 


3.6.5.3 Identically Named Files - The problem of duplicate file 
names is apparent on two levels. In the first case, it is possible 
for a previous edit run to have been aborted with one of the 

Editor's temporary files (normally .TFIL1 EDT) closed on the output 
device. The closing of the temporary file created during the current 
edit run results in the deletion of the like-named file from the 
previous run. To enable the retrieval of prior work, the Editor 


types the comments: 


FILE .TFIL1 EDT IS PRESENT ON OUTPUT DEVICE. 
PLEASE RENAME IT OR IT WILL BE DELETED. 


If the user wishes to preserve the contents of .TFIL1 EDT, he must 


rename it using the CALL request (see Paragraph 3.7). 


At the second level, it may happen that the file name given in a 
CLOSE sequence is identical to that of another file on the (current) 


output device. In such cases, the program types: 

PLEASE TYPE IN ANOTHER NAME 
and outputs a go-ahead symbol (>). The Editor then waits for the user 
to enter another file name and extension (SRC assumed if none given). 


The request message will be repeated until an acceptable file name 


is entered. 


If the file processing has proceeded to a point at which recovery, as 


described above, is impossible, the Editor recognizes a priority 
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scheme when file name difficulties are encountered. An attempt is 
made, first, to ensure that the new (modified) version of the file 
being edited is left on .DAT slot -14 and properly named. If that 

is impossible, the program tries to leave the new file (again, 
properly named) on .DAT slot -15. If that cannot be done either, then 
the new file is left on .DAT slot -15 and is named .TFIL1 EDT. The 
Editor then reports the nature of the difficulty, the final destina- 


tion of the file, and its current name, thus: 


FILE [filename ext] IS PRESENT ON OUTPUT DEVICE ms, 
YOUR EDITED FILE IS ON .DAT -14 (OR -15) AS [newfile ext] : 
ORIGINAL FILE DELETED. 


The user now knows the residence of his edited file (.DAT -14 or 
-DAT -15) and the name under which it can be accessed. 


3.6.5.4 Nothing in File - The following error message can result 

from issuing a CLOSE command prior to a WRITE command when Block 

Mode is ON, or by having OUTPUT turned off when a WRITE or CLOSE 

command is issued: = 
NOTHING IN FILE 

In any event, control returns to the Editor. The contents of the 

buffer remain unchanged. In the case of directoried input and 

output, the input file is left unchanged. 

3.7 FILE RENAMING AND DELETION 


The Editor provides two commands: 


a) CALL DELETE 


b) CALL RENAME 


which enable the user to either delete or rename any file on the 


Editor's input or output devices/UFD's. 


These commands are described in detail in Chapter 4. 


CHAPTER 4 
EDIT MODE COMMANDS 


4.1 INTRODUCTION 


The form and use of each command permitted in Edit Mode are described 

in this section. The command descriptions are presented in five 

basic functional groups (i.e., setup, I/O, locative, manipulative, and 
close); examples are given where possible. The following conventions 


are observed throughout this section: 


ae Where commands may be abbreviated, the legal 
abbreviation is specified, within brackets, 
immediately after the command's full name. 
For example, "NEXT [N] - indicates that the 
command NEXT may be abbreviated as "N". 


b. When arguments may be added to or are required 
as part of a command, the command name must be 
separated from its argument by a single blank 
character (space ws). The blank delimiter is 
considered as part of the command, not part of 
the command's argument string. For example, 
the command RETYPEus/COMMENT results in the 
line: /COMMENT. 


If more than one blank appears between the command and its argument 
string, all blanks except the first are considered as part of the 


argument. 
For example, the statement: 
FIND eu 4/COMMENT ./ 


results in a search for a line which begins with the character string 


404 /COMMENT 47 
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4.1.1 Example File 


The following file or portions of it are used throughout this 
chapter to illustrate the operations performed by the Edit commands. 
The contents of this file (i.e., EXAMP) are meaningless; this 
enables the command functions to be demonstrated without regard to 


proper programming techniques or requirements. The file is: 


-TITLE EXAMP /EDIT COMMAND DEMONSTRATOR 
TAGL AAA /LINE 1 
BBB 
cee 
TAG2 DDD /LINE 4 
EEE 
FFF 
TAG3 GGG /LINE 7 
HHH 
III 
. END 


4.2 SETUP COMMANDS 


Edit Mode setup commands are required at the start of an editing 
session to define and give parameters for the possible Editor features 
which the user may employ and to delete or remove the file residing 

on the input device. The setup commands are described, individually, 
in Sections 4.2.1, through 4.2.9. 


4.2.1 CALL RENAME Command 


Form: 


INPUT 


CALLLuRENAME wo (aun 


wu OLDNAMLIEXTLUNEWNAMLUEXT 


Description: 


This command must be used before the OPEN command (see 4.2.3) is 
issued or after a CLOSE command. It may be used repeatedly, and 
may be issued in any order with the CALL DELETE command (see 4.2.2). 


The RENAME command permits the user to change the name of any file 
located on either the input or output device. No abbreviation is 


permitted. 
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Example: 
The following example illustrates the use of the RENAME command in a 
DOS system to rename input file XXX SRC to the name NMTST SRC. 


24-NOV-75 listtin 3 
DIRECTOPY LISTING (VIC) DOS oa oe 
2436 FREE BLKS 
1 USER FILES 
1 USFR PLKS 
XXX SPC 1! 24-NOV-75 entry for file "XxX src" 


EDITOR XV¥N Vrixnmmn 
>CALL RENAME INPUT XXX SRC NMTST SRC RENAME Command, change name 
ad of file XXX SRC to NMTST SRC 


2 4-NOV- 75 listing of resultant UFD 
DIRECTORY LISTING (VIC) 
2436 FREE RBLKS 
1 USER FILES 
1 USER BLKS 
NMTST SRC 1 @2-0CT-71 entry of renamed file 


4.2.2 CALL DELETE Command 
Form: 


INPUT 


aa wu FILNAMWUEXT 2/ 


CALLwuDELETE wy 


Description: 


This command must be issued before the OPEN command (see 4.2.3) is 
issued or after a CLOSE command. It may be used repeatedly and may 
be issued in any order with the CALL RENAME command (4.2.1). The 
DELETE command permits the user to delete any file from the directory 
of any device (or UFD) used as either the input or output device. 


No abbreviations are permitted. 


Example: 


The following example illustrates the use of the DELETE command in a 
DOS system to delete the file NMTST SRC from the current (input) UFD. 


2 4-NOV- 75 listing of current UFD tn DOS 
DIRECTORY LISTING (VIC) System 
2436 FREE BLKS 
1 USER FILES 
1 USER BLKS 


NMTST SRC 1 92-0CT-71 entry for file "NMTST SRC" 
EDITOR #VNO Viner 
>CALL DELETE INPUT NMTST SRC DELETE Command, delete file NMTST 
= from input device (t.e.,current 
UFD) 
24-NON-75 listing of resultant UFD 


DIRECTORY LISTING CVIC) 
2437 FREE BLKS 
@ USER FILES 
@ USER BLKS 
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4.2.3 OPEN Command 

Form: 
OPENwufilenameruext «/ 

Description: 


Edit Mode operations are initiated by the entry of this command. When 
entered, the Editor searches the Input device for the named file. If 
the file is found the program outputs the word EDIT and a go-ahead 

symbol (i.e., >); if the file is not found, the program outputs the = 


message: 


FILE filename ext NOT FOUND 
INPUT 


The word INPUT indicates that an intermediate write file has been 
opened on the output device. Any inputs from the Keyboard are written 


into the intermediate file, line-by-line. _, 


Normal files found on the input device are open for reading and sub- 


sequent Edit operations. 
Example: 


The following are examples of the responses obtained when an existing 


and a nonexistent file are named in an OPEN command. 


EDITOR X¥No YVnerniruy 
>OPEN EDTST SRC opening an existing ftle a, 
EDIT 


> 


TP 

EDITOR AVN Venrn OPEN Command referenctng 
>OPEN AAA SRC a nonextsting file 
FILF AAA SRC NOT FOUND. 

INPUT 
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4.2.4 PUT Command 


Form: 


PUT Lufilenamecsext «/ 
Description: 


Frequently, the user wishes to place portions of a file into many 
separate source files. The PUT command allows the user to do this. 
If the user specifies a filename ext that already exists, the program 
will type: 


filename ext IS ALREADY PRESENT ON .DAT -13. 
and will then wait for the next Editor command. 


If no file name is used, the input file name is assumed with an ext 
of SRC and the program types: 


NO FILE NAME SPECIFIED: 
FILE: filename ext IS ASSUMED. 


While the PUT is in effect, the output stream will be copied to 
-DAT -13. 


4.2.5 BLOCK ON/OFF Command 
Form: 


on |) 


piock + |O%e| 


Description: 


This command (normally OFF) is used to establish a mode of operation 
in which the Editor sets up a buffer in core to retain a defined sub- 
set of the input file for edit operations. The size of the block 
"buffer" may be set by the user during the Edit SIZE command or a 


default size of 55 0 lines may be accepted. 


1 


Edit Mode Commands 


Once established, the block buffer is loaded by a READ command; ali 
normal editing operations may then be performed on the contents of 
the buffer. On completion of editorial operations, the contents of 
the buffer are output onto the output file by a WRITE command. A 
RENEW command which writes the contents of the buffer onto the output 
file and then loads the next subset of the input file into the buffer 
may also be used. 


The Block Mode may be turned ON or OFF at any time during the edit 
operations. Once the size of the buffer is established, it will 
remain in effect until the Editor is restarted or another SIZE com- 
mand is issued. 


NOTE 


If either the input or the scratch file device is 

a non-directoried device, the Block Mode is automa- 
tically turned ON by Edit. If both input and scratch 
devices are directoried devices, Block Mode is set 
OFF when Edit is loaded. 


The command 
BLOCK «/ 

(without arguments) is equivalent to 
BLOCKWUUON Py 

Example: 


1) Assuming that the example file EXAMP SRC is on the input device 
and is opened, the following commands set up a Block Mode with 
a 4-line buffer, load and print out the buffer: 


tP in 
EDITOR “VN Mexricn 
>OPEN EXAMP SPC 
EDIT F 
set up BLOCK Moae . 
el set size of buffer to 4 Lines = 
PEA load buffer from tnput file (EXAMP 
oe PRINT contents of buffer 
‘ eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE 1 
BBR 7 
ccc 


CONTENTS OF BLOCK MODE BUFFER 
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2) When the Block Mode is OFF, the entire input file is loaded, 


line-by-line, into the Editor work area; this is illustrated 
by the following: 


EDIT 
>WRITE empty buffer 
>BLOCK OFF turn BLOCK mode OFF 
>T go to the top of the file in core 
>P 28 PRINT up to 20 lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR | 
TAG! AAA /LINE 1} 
RBB 
ccc 
TAG2 DDD /LINE 4 printout of file 
FEE loaded tn core for 
FFF Edit operattons 
TAG3 GGG /LINE 7 
HHH 
Ill 
o END 
END OF FILE REACHED BY: message printed to indtecate that the 
P 20 end of the file was reached before 
> 20 Lines were printed. 


4.2.6 SIZE [S] Command 
Form: 

SIZEwuN 
where: 


N is a decimal number which specifies the number of lines 
which the Block Mode buffer is to contain. 


NOTE 
The name SIZE may be abbreviated as S 
(e.g., Suu3./)- 


Description: 


This command applies only to READ and RENEW operations. It enables 
the user to specify, in number of lines, the size of the current 
Block Mode buffer. A size greater than 1 must be specified or an 


error will occur. 
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If a SIZE command is not used, the Editor program assumes a default 


size of 55 lines. The default size is restored each time the 


10 
Editor is restarted. 


Whenever a BLOCK ON command is given, it should be followed by a 
SIZE command unless the default size is acceptable. 


Example: 
The command 


a) Suu5 establishes a 5-line buffer 


b) Seld0 establishes a 100-line buffer 
4.2.7 VERIFY [V] ON/OFF Command 


Form: 


ON 
VERIFY wu oy wy 


NOTE 
The name VERIFY may be abbreviated as V 
(e.g., VeuON,/). 


Description: 


The VERIFY command (normally ON) enables the user to determine 
whether or not a response is printed for certain Edit commands to 
verify that they were carried out. Some of the responses printed 


are: bins 
a) the line brought into the work area as the result 
of a FIND or LOCATE command is printed 


b) the last line of a file or block buffer brought in 
by the BOTTOM command is printed 


c) the new line resulting from a CHANGE request is 
printed. 


With the VERIFY mode OFF, only error messages are printed. 
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The command: 

VERIFY «/ (or Vs) 
is equivalent to 

VERIFYWuON./ (or Viu0Ns/) 
Example: 


The following example illustrates the function of the VERIFY mode: 


eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 


TAG! AAA /LINE 1 
BBR current contents of block buffer 
ccc 
>T go to top of buffer 
>VERIFY ON turn Vertfy Mode ON 
>F TAG find line in buffer containing string "TAG" 
TAG! AAA /LINE 1 total line ts printed to Vertfy operatton 
>T go to Top of buffer 
>VERTFY OFF turn Verify Mode OFF 
>F TAG repeat FIND command 
> a go-ahead symbol is printed to indteate 
operation was completed, the line ts not 
printed. 


4.2.8 BRIEF ON/OFF Command 


Form: 


BRIEFwy {or ! 


Description: 


This command (normally OFF) enables the user to determine if the 
printed response to certain Edit commands is printed in a full 

(BRIEF OFF) or an abbreviated (BRIEF ON) form. For example, response 
made to the FIND, LOCATE, and BOTTOM commands will contain only 

items in the tag, operation code, and address fields, if the BRIEF 


mode is ON. 
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The VERIFY mode must be ON for the BRIEF mode command to have any 
effect on printed response. 


The command given without an ON/OFF argument (i.e., BRIEF «/) is 
equivalent to a BRIEFLu0N./ command. 


Example: 


The following example illustrates the manner in which the BRIEF 

mode affects the response to the command FuuTAG./ : oo 
VERIFY ON 

>BRIEF OFF turn Brief Mode OFF — 
>T go to Top of buffer 

>F TAG find line containing the string "TAG" 

TAG] AAA /LINE 1 total line ts printed to Verify operation 

>T go to Top of buffer 

>BRIEF ON turn Brtef Mode on 

>F TAG repeat Find command 

TAG] AAA an abbreviated line is printed to 

> Verify operatton 


4.2.9 OUTPUT ON/OFF Command 


Form: 


ON 
OUTPUT us ‘aoe 


Description: 


The OUTPUT command is always ON when the Editor is loaded into core, 
and during normal Edit operations. When set to OFF, the OUTPUT 
command enables all Edit commands to be used; however, no data will 
be output to the output or scratch devices on .DAT -15. Alsoa 
NOTHING IN FILE message is output on the console printer if a WRITE 


command is issued. 


This command may be issued at any time during file edit operations. 
Its use enables the operator to go through a file and output only 
selected portions of the file to what will be the final or new file 


when a CLOSE command is issued. 
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Example: 


The following example illustrates the use of the OUTPUT command; as 
shown, this command is used to delete a segment of the file being 


edited. 


TP 
EDITOR X¥N Viner 
ce EXAMP SRC open demonstration program 
>P 12 Print 12 lines of current file 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAGI AAA /LINE 1 
BBB 
ccc 
TAG2 DDD /LINE 4 
EEE current (ortgtnal) contents 
FFF of file being edited. 
TAGS GGG /LINE 7 
HHH 
IT!t 
oe END 
>T go to Top of file 
>F TAG2 Find tine starting wtth "TAG2" 
TAG2 DDD /LINE 4 printout of selected line 
>OUTPUT OFF OUTPUT "OFF" command 
>F TAG3 Find line starting wtth "TAG3" 
TAG3 GGG /LINE 7 printout of selected line 
>OUTPUT ON OUTPUT "ON" command 
>R go to Bottom of file 
END printout of last line in file 
>CLOSE Close file and terminate Edit operations 
EDITOR XVM Virose 
>OPEN EXAMP SRC reopen demonstrator program 
EDIT 
>P 12 Print 12 lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE 1} | 
BBB 
CCC contents of the demonstrator 
TAG3 GGG /LINE 7 program as modtfied by the 
HHH OUTPUT ON/OFF command in the 
Ill prevtous Edit operatton. 


«END 
END OF FILE REACHED BYs: 
P i2 


> 
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4.2.10 KEEP [K] Command 


Form: 
KEEP, Savnam ext) where "Savnam" is the name of the 
file to be saved. If an 
extension is not given, "SRc" 
is assumed. 
NOTE 
KEEP may be abbreviated as K (e.g., 
Ky savnam,_,ext,)). —, 
Description: “< 


This command causes the current input file on .DAT -14 to be preserved 

for back-up purposes. As many KEEP commands may be issued as desired; 

however, each "savnam" must be different from any other file name on 

the device at .DAT -14. Normally, the KEEP command may be issued 

only while the input file is at .DAT -14 (i.e., the numbers of TOPs 

issued must be even, 0, 2, 4,...). However, if the same device and a 
UIC are assigned to both the I/O and scratch functions (such as opera- 

ting with a file in a DOS UFD) the number of TOPs issued with the KEEP 

command need not be even. The actual renaming of the input file, 

however, is not done until the next TOP, CLOSE, or EXIT command is 


issued. 
Example: 


The following example illustrates the use of the KEEP command to 


maintain both the original and edited files: 


24-NOV-75 
DIRECTORY LISTING (JAN) 
2437 FREE BLKS listing of UFD on 
1 USER FILES tnput .DAT slot 
1! USER BLKS 
EXAMP SRC 1 62-0CT-71 note stngle file entry 
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EDIICR XVN Vrixmmt 
>QOPEN EXAMP SRC 


ree EXAMP keep ftle "EXAMP SRC" intact on input dev. 
>F TAG Find file line beginning "USING" 

TAG! AAA /LINE 1 printout vertfying Find operation 

>T go to the Top of the file 

FILE EXAMP SRC IS PRESENT ON INPUT DEVICE, vequest for new name for output 
PLEASE TYPE IN ANOTHER NAME, file intttated by @ (TOP) com'd 
>EXAMP? new name 

>CLOSE Close file and restart Editor 


EDITOR XVN Vnxnmn 


> 


2 4-NOV-75 
DIRECTORY LISTING (JAN) listing of UFD on 
2436 FREE BLKS input .DAT slot after 
2 USER FILES Edtt operattons 
2 USER BLKS 
EXAMP2 SRC 1 2@4-NOV-75 --|- original file 
EXAMP SRC 1 24-NNV-75~—-~J- new file 


4.2.11 PARITY ON/OFF Command 


Form: 
ON 
PARITY wu {ore| s 
Description: 


When the Editor is initially loaded and restarted, PARITY is enabled. 
This means that paper tapes which are input will be parity checked. 
However, parity checking can be turned off via this command to enable 
reading of paper tapes with no parity. In this case, the user must 
take special care to be sure that the data input is correct. 


4.3 INPUT/OUTPUT COMMANDS 


The Edit Mode commands which are used to input and output data during 


editing operations are described in paragraphs 4.3.1 through 4.3.4. 
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4.3.1 READ Command 


Form: 
READ ) 


Description: 

The READ command is permitted in the BLOCK ON mode of operation only. 
This command fills the Block buffer with sequential lines from the 
input file. Once filled, the buffer must be emptied before another 
READ command can be issued (see WRITE and RENEW). The number of input 
file lines read into the current block buffer is determined either by 
the value specified in a previously entered SIZE (S) command or, if se 
S is not given, the default value 5549 is used. 

On completion of a READ operation, the current line pointer is posi- 


tioned one line above the first line of the buffer. 


Example: 
The following illustrates the manner in which the READ command is used 


to load a four-line Block Buffer. 





EDITOR #=VN Vrerinn 
>OPEN EXAMP SRC 
EDIT 
>BLOCK ON turn BLOCK mode ON 
>S 4 setup a four-line block buffer 
>R EAD ftll buffer from input file pa 
>P 5 PRINT five lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE 1! 
BBB contents of 
ccc block buffer 
a = 
>WRITE WRITE buffer contents on output/seratch file 
>R FAD fill buffer with next sequential set of lines 
>P 5 PRINT five Lines 
TAG2 DDD /LINE 4 
FEE contents of 
FFF block buffer 
TAGS GGG /LINE 7 hae ee ee ee NE OEE 
> 


4-14 


Edit Mode Commands 


4.3.2 WRITE Command 


Form: 
WRITE) 


Description: 

This command is permitted in only BLOCK ON modes of operation. It 
causes the contents of the current block buffer to be written onto 
the output file and then clears the buffer. The WRITE Command may be 


issued at any time during a Block mode Edit operation. 
4.3.3 RENEW Command 


Form: 
RENEW) 


Description: 

This command is permitted only during BLOCK ON modes of operation. 
The RENEW command causes a buffer write-clear-fill sequence of 
operations to be performed. This command replaces a WRITE, READ 


command sequence. 


On completion of a RENEW operation, the current line pointer is posi- 
tioned one line above the first line of the buffer. 


Example: 
EDITOR #VNo Viiosmnonm 

>OPEN EXAMP SRC 

EDIT 

>BLOCK ON turn BLOCK mode ON 

>$ 4 set up a 4-line buffer 

>R EAD ftll buffer from input file 

>P 5 PRINT 5 tines 
elITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 

TAG ied ALINE 1 contents of buffer 
ccc 

>RENEW write, elear and fill buffer 

>P 5 PRINT 5 lines 

TAG2 DPD /LINE 4 
EFE new contents of buffer 
FFF 

TAGS GGG /LINE 7 


> 
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4.3.4 GET [G] Command 


Form: 
n 
GEE | filename ext a 
where: 
n is a decimal number 
or = 
filenamewuext is the name of the file to be inserted 
NOTE = 
GET may be abbreviated as G (e.g., Ge sal). 
Description: 


In general, this command causes some number of lines from the subsi- 

diary input device to be added to the output file. New lines are —, 
added below the current line. When command processing is complete, 

the last line read from the subsidiary device is left in the work 


area as the current line. 


If the device assigned to .DAT -10 (subsidiary input) is non-direc- 
toried, the GET command expects the argument "n" which is the decimal 
number of lines to be read. If n is omitted, it is assumed to be l. 
If an end-of-medium condition is encountered on the subsidiary input 


device before n lines are read, the error message: 


END OF MEDIUM REACHED BY: 
GET n 


is printed. The pointer remains at the last line read. 
If a directoried device! is assigned to .DAT -10, the GET command 


expects the argument "filenamewsext". The entire contents of the 


named file will be inserted into the output file. 





Not supported in the XVM/RSX EDITOR. 
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Example: 


The following printout illustrates the manner in which data from a 
non-directoried subsidiary input device is inserted into a file using 
the GET command. 


EDITOR XVM Vrixnnn 
>OPEN EXAMP SRC 
EDIT 
>L TAG2 LOCATE line contatning string "TAG2" 
TAG2 DDD /LINE 4 vertficatton printout 
>GET 3 GET 3 lines from subsidtary dev; insert in file 
>T go to TOP of file 
>P 20 PRINT 20 lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAG] AAA /LINE 1 
BBB 
ccc . 
TAG2 DDD /LINE 4 inserted 
THIS MESSAGE IS BEING ADDED TO THE OUTPUT FILE Lines contents 
FROM THE SUBSIDARY INPUT DEVICE (PR IN THIS CASE) of file 
USING THE GET COMMAND 
FEE 
FFF 
TAG3 GGG /LINE 7 
HHH 
ITI 
2 END 
END OF FILE REACHED BY: 


P 28 


> 


4.4 LINE POINTER CONTROL (LOCATIVE) COMMANDS 


During editing operations, the Editor program maintains a pointer 
which identifies the current line (i.e., the line which any subsequent 


editing operations will affect or will be referenced to). 


Commands are provided which permit the user to control the positioning 
of the "current line" line pointer and to cause the pointer to be set 
to a line identified only by a text string contained by the line. The 
commands provided enable the user to: 1) set the line pointer to 
either the Top or Bottom of a file or buffer, 2) move the line pointer 
a specified number of lines away from its current position, and 3) 

make a line, identified only by a text string, the current line. 


Edit Mode Commands 
4.4.1 TOP [T] Command 


Form: 
TOP ) 


NOTE 


This command may be abbreviated as , 
(e.g.-, T ). 


Description: 

The T command causes the line pointer to be moved to one line position 

above the first line of the file or buffer being edited. The pointer ~ 
is positioned in this manner to enable the user to insert, if desired, 

data before the first line of the file or buffer. The TOP command aaa 
may be entered at any time during the Edit operations. 


Example: 
The following example illustrates the use of the TOP command and 
the fact that it is positioned above the current file or buffer. 


EDITOR X¥VNo Vnemmr 
>OPEN EXAMP SRC 
EDI T . e . . . . n " 
>L TAG2 LOCATE line in file containing string "TAG2 
TAG2 DDD /LINE 4 vertftcatton printout 
>TOP go to TOP of file 
>P PRINT current line (nothing ts printed since 
>N go to NEXT line pointer is above first line of the ftle) 
>P PRINT current line 


.TITLE EXAMP /EDIT COMMAND DEMONSTRATOR first line in ftle 


> ~_—, 


4.4.2 NEXT [N] Command 


Form: 
NEXT, ,n J where n is a decimal number. 
NOTE 
This command may be abbreviated as N (e.g., Nou5./) 
Description: a 


This command enables the user to move the line pointer a specified 
number, n, of lines towards the bottom (end) of a file or buffer. 
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The NEXT operation begins with the line current when the command was 
issued and ends with the line pointer at the position "current line 


+n". During the line-by-line (File) mode, lines skipped over are 
added to the output file. 


The N command may be issued at any time during Edit operations. If a 
value is not given for n, it is assumed to be l. 


If an N command results in the pointer being moved past the last line 
of the file or buffer, the error message: 


FILE 


se da ss 


REACHED BY: 


NEXT n 
is printed at the console. The pointer is positioned past the last 
line of the file. More text can be added at this point and all 
editor commands are legal. 


Example: 


The following illustrates the use of the NEXT command. 


EDITOR XVN Vresnrii 
>OPEN EXAMP SRC 
EDIT 
=P 2 PRINT two lines ; 
eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR first line of ftle 
>NEXT 3 move potnter three lines 
>P PRINT current line 
ccc eurrent line 
>N 2 move pointer two lines 
>P PRINT current line 
EEE current line 
>N move pointer one line 
>P PRINT current line 
FFF eurrent tltine 
>N 12 move pointer twelve Lines 
END OF FILE REACHED BYs error message 
N 12 
> 
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4.4.3 BOTTOM [B] Command 
Form: 
BOTTOM) 


NOTE 


This command may be abbreviated as B 
(@-ge, Bs 


Description: 
The B command causes the line pointer to be moved to the final line 


of the file or buffer being edited. In a file mode of operation, any 


lines skipped over are added to the output file. 
Example: 
The following verifies that the BOTTOM command will move the pointer 
to the last line of a buffer: 

tP 

EDITOR XUN Vins 

>OPEN EXAMP SRC , 
EDIT 

>BLOCK ON turn BLOCK mode OWN 

>S 5 setup a ftve-line buffer 

>READ load buffer from input file 

>P 6 PRINT stx lines (t.e.buffer contents) 

eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR 
TAG] AAA /LINE 1 
pe current contents 
b 

TAG2 DDD /LINE 4 i hia 

>T move potnter to TOP of buffer em 
>BOTTOM move potnter to last line of buffer 

TAG2 DDD /LINE 4 line printed to vertfy operation 

> 


4.4.4 FIND [F] Command 


Form: 
FIND, string J 
NOTE 
This command may be abbreviated as F 
(e.g., FesABC./). 
Description: 


The F command causes a sequential line-by-line search to be made of 
the file or buffer being edited for the first occurrence of a line 
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which begins with the specified "string". The search starts below the 
current line; if the specified line is found, it becomes the current 
line and is printed at the console. If a line starting with the 

given string is not found, the line pointer is positioned immediately 
below the last line of the file (or buffer) and the message: 


BUFFER 
FIND (or F) string 


END OF { aed } rence BY: 


is printed at the console. 


In entering an identifying string, the user must ensure that it 
matches exactly the beginning of the line to be found. The command 
string must include all tabs and/or spaces preceding or within the 
first portion of the desired line. 


Example: 


The following illustrates the use of the FIND command. 


EDITOR “VN Viner 
>OPEN EXAMP SRC open demonstratton program 
EDIT 
>FIND TAG3 make line starting "TAG3" eurrent 
TAGS GGG /LINE 7 vertfteatton printout 
>T go to TOP of ftle 
>FIND END make line starting ".END" current 


FIND END (the user omitted the tab preceding .END) 


> 


END OF FILE REACHED “oy error message, the line was not found 


4.4.5 LOCATE [L] Command 


Form: 
LOCATE, ,string, 
NOTE 
This command may be abbreviated as L 
(e.g., LuwABC,/). 
Description: 


This command causes a line-by-line search to be made of the file or 
buffer being edited for the next occurrence of a line containing the 
specified string. The identifying string may consist of only print- 
able characters and need not be a complete word. The string given, 


however, should be unique, within the file or buffer, to the desired 


line. 
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The initiated search starts at the next line. If the specified string 
is found, the line containing it becomes the current line and is printed 
at the console. If the identified line is not found, the line pointer 
is moved immediately below the last line of the file or buffer and the 


message: 


FILE 
END OF ae REACHED BY: 


LOCATE (or L) string 
is printed at the console. 


Example: 
The following illustrates the use of the LOCATE command: “ar 


EDITOR XVN Veron 


>OPEN EXAMP SRC open demonstratton program 

EDIT 

SLOGATE TAG3 make line containing "TAG3" current 

TAGS GGG /LINE 7 vertftcattion printout 

>T go to TOP of file 

>L G3 make Line contatning "G35" current 

TAGS GGG /LINE 7 vertficatton printout —~ 
>T go to TOP of ftle 

->L NE 7 LOCATE line contatning "NE 7" 

TAGS GGG /LINE 7 vertficatton printout 

>T go to TOP of ftle 

>L 7222 make line contatning "222" current 

END OF FILE REACHED BYs error message, no line containing "222" 

L 22Z was found 

> 

4.5 TEXT MODIFICATION AND MANIPULATIVE COMMANDS ~—~ 


The Edit Mode commands which enable the user to view, change data, 
and modify the structure of the current file or buffer are described 
in paragraphs 4.5.1 through 4.5.13. Explicit examples of the use of — 


this type of Edit command are given wherever possible. 


4.5.1 PRINT [P] Command 


Form: 
i i ber. 
PRINT, ,n) where n is a decimal numbe 
NOTE 
This command may be abbreviated as P ey 


(e.g., Pusn,/)- 
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Description: 

This command permits the user to print, at the console, one line or a 
group of "n" lines of the current file or buffer. Print operations 
start at the current line; the last line printed becomes the current 
line. If no value is given for "n", it is assumed to be 1; the 
command p./ causes the current line to be printed; however, it will 


also remain the current line after being printed. 


After a TOP command, the user must specify n+l lines to get the de- 
sired printout, since the line pointer will be one line above the 


first line of the file or buffer. 


If the value of n is too large, it will cause the current file/buffer 
line pointer to be moved past the last line of the file/buffer and 


the message 


) FILE 
END OF (oe } REACHED BY: 


P, A 


is printed at the console. 


Example: 
The following annotated listing illustrates the use of the PRINT 
command. 
EDITOR “VEO Vroom 
epee EXAMP SRC OPEN demonstration program 
I 
>PRINT 5 PRINT 5 lines 
elITLE EXAMP 7EDIT COMMAND DEMONSTRATOR lines printed. 
TAG! AAA /LINE 1 note only four 
BBB lines printed 
ccc because line 
>P 2 PRINT 2 lines potnter was above 
ccc first file line 
TAG2 DDD /LINE 4} shia cvinca 
>P PRINT current line 
TAG2 DDD JLINE 4 response 
>P 19 PRINT ten lines 
TAG2 DDD /LINE 4 
EEE 
FFF all remaining file lines printed 
TAGS GGG /LINE 7 in response to the P 1 command 
HHH 
II! 


P 10 before ten lines were printed 
> 


e END 
END OF FILE REACHED ae error message; the end of ftle was reached 
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4.5.2 LIST Command! 
Form: 
LIST una’ where n is a decimal number 
Description: 


This command permits the user to list to the device (generally a 
line printer) assigned to .DAT -12, one line or a group of "n" 
lines of the current file or buffer. List operations start at 
the current line; the last line printed becomes the current line. 


If no value is given for "n", it is assumed to be one. The command ann 
LIST causes the current line to be printed; however, it will also 


remain the "current" line after being printed. 


After a TOP command, the user must specify n+l lines to get the 
desired printout, since the line pointer will be one line above 
the first line of the file or buffer. 


If the value of n is too large, it will cause the current file/buffer 
line pointer to be moved past the last line of the file/buffer and 
the message: 


FILE 


= REACHED BY: 


END OF 


LIST n 
is printed at the console. 
Because of the possibility of listing to a UNICHANNEL line printer 
with spooling enabled, the EDITOR issues,.a .CLOSE command at the 


end of each operation and initializes the printer handler to not 


perform a form feed when .CLOSE is received. 


INot supported by the XVM/RSX editor. eon 
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4.5.3 DELETE [D] Command 


Form: 
DELETE, .n, where n is a decimal number. 
NOTE 
This command may be abbreviated as D 
(e.g., Duun./) . 
Description: 


The DELETE command enables the user to remove one or more lines from 
the current file or buffer. If a value for n is not given, the value 
1 is assumed. Whenever a line is deleted, the line pointer is moved 
to the next line. If the value of n is too large, the pointer is 
moved below the last line in the file or buffer and an end~of-file/ 
buffer message is printed at the console. 


Example: 


The following example illustrates the use of the DELETE command. 


EDITOR X¥N Vexsninn 
>OPEN EXAMP SRC OPEN demonstrator program 
EDIT 
>BLOCK ON turn BLOCK mode ON 
2S 6 establish a stx line buffer 
>R EAD load buffer 
>P 7 PRINT eontents of buffer 
eTITLE EXAMP /EDIT COMMAND DEMONSTRA OR 
TAGI AAA /LINE 1 
BBB 
ccc contents of 
TAG2 eae /LINE 4 block buffer 
>T go to TOP of buffer 
>L BBB LOCATE line eontatning "BBB" 
BBB verification printout 
>DELETE DELETE current Line 
>T go to TOP of buffer 
>P 7 PRINT contents cg pute” 
eTITLE EXAMP ZEDIT COMMAND DEMONSTRATOR 
TAGI AAA /LINE 1 contents of 
ccc bloek buffers 
TAG2 DDD /LINE 4 note line con- 
EEE taining BBB 
P 7 


Edi 
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>T g 
>L ccc WA 

ccc v 
>D 3 D 


END OF BUFFER REACHED BY: 
D3 


>T g 
>P 6 va 

eTITLE EXAMP /EDIT 
TAG! AAA /LINE 1 


END OF BUFFER REACHED BY? 
P 6 


o to TOP of buffer 

OCATE line contatning "CCC" 
ertficatton printout 

ELETE 8 lines ineluding current line 


o to TOP of buffer 

RINT contents o but ee 

COMMAND DEMONSTRAT 
contents of 
buffer after 
DELETE operatton 


> 


4.5.4 RETYPE [R] Command 
Form: 
RETYPE, ,line J 
NOTE 
This command may be abbreviated as R 
(e.g., RuuTHIS IS A NEW LINE_/). 
Description: 


This command causes the current line to be replaced, entirely, by the 
line given in the command. 


Example: 
The following illustrates the use of the RETYPE command: 


EDITOR <8 Veron 
>OPEN EXAMP SRC OPEN demonstration program 
EDIT ; : 
>P 6 PRINT stx lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE } 
oe first stx lines 
O ile 
TAG2 DDD = /LINE 4 tf 
>T go to TOP of ftle 
>L BBB LOCATE line econtatning "BBB" 
BRB vertfteatton printout 
>RETYPE THIS MESSAGE REPLACES LINE BBB RETYPE command 
>T TOP command 
>P 6 PRINT six lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR ‘ . ; 
TAG! AAA /LINE 1 first ftve lines 
THIS MESSAGE REPLACES LINE BBB of file; note 
ccc change in line 
TAG2 DDD 7LINE 4 BBB 


> 
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4.5.5 INSERT [I] Command 
Form: 
INSERT J 
NOTE 
This command may be abbreviated as I 
(i.e., I). 
Description: 


This command enables the user to insert, via the keyboard, one or 
more lines between selected lines of the current file or buffer. When 


the INSERT command is issued and the operating mode is changed from 


EDIT to INPUT, the user may key in any desired data. 


tion is terminated by the 
Once EDIT 
will be positioned at the 


ing only a). 


Example: 


The following illustrates 


EDITOR XVEOo Vinny 
>OPEN EXAMP SRC 
EDIT 
>P 6 
eTITLE EXAMP 
TAG! AAA /LINE 1 
BBB 
CCE 
TAG2 DDD /LINE 4 
>T 
>L BBB 
BBB 
>I NSERT 
INPUT 
1111 ADDED LINE 
2222 ADDED LINE 
3333 ADDED LINE 
EDIT 
>T 
>P 1 
elITLE EXAMP 
TAG! AAA /LINE } 
BBB 
W111 ADDED LINE 
2222 ADDED LINE 
3333 ADDED LINE 
ccc 
TAG2 DDD /LINE 4 
EEE 


> 


The INPUT opera- 
entry of a null line (i.e., a line contain- 
mode is restored, the current line pointer 
last line entered. 


the use of the INSERT command. 


OPEW demonstrator program 


PRINT stx lines 


7EDIT. COMMAND DEMONSTRATOR 


first five ltnes 
of current file 


TOP 
LOCATE ltne contatning "BBB" 


INSERT command 
INPUT mode identtfter 


inserted matertal 


EDI? mode tdentifter 


TOP : 
PRINT ten lines 


ZEDIT COMMAND DEMONSTRATOR 


contents of ftle; 
note inserted 
matertal 
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4.5.6 INSERT [I] Line Command 


Form: 
INSERT, ,line) 


NOTE 


This command may be abbreviated as I 
(e.g., InaTHIS IS NEW._/). 


Description: 


This command enables the user to insert a single line between lines 
of the current file or buffer without changing the operating mode. _ 
When an I, ,line command is issued, the current line is added to the : 
output file and the argument of the INSERT command becomes the current 
line. Note that the insertion is made below the current line when the 


command is issued. The EDITOR remains in the Edit Mode throughout the 
execution of this command. 


Example: 


The following illustrates the use of the INSERT command. 


EDITOR #VN Veo 


>OPEN EXAMP SRC OPEN demonstrator program 
EDIT ; ; 
>P 6 PRINT stx lines 
.TITLE EXAMP /EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE 1 first five 
BBB lines of 
coc current file 
TAG2 DDD /LINE 4 TOP 
ute LOCATE line "BBB" ~~. 
ann INSERT command 
>INSERT 1111 INSERTED LINE 
>T TOP 
"P10 TITLE. EXAMP—/EDIT COMMAND DEMONSTRATOR se kag Oe de 
TAG] AAA /LINE 1} wale ies ee 
B 


serted 
immedtately 


BB 
Lili! INSERTED LINE 
hs following line 


EEE 
FFF 
TAG3 GGG /LINE 7 


> 
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4.5.7 CHANGE [C] Command 
Form: 
CHANGELs/string 1/string 2/./ 


NOTE 


This command may be abbreviated as "C" 
(e.g., Ceu/KAT/CAT/,/ ); also, the use 
of the final separator (/) is optional. 
Delimiters other than / may be used; 
any character (including blanks) which 
does not appear in stringl or string2 
may be used as the delimiter. 


Description: 


This command enables the user to replace selected portions of a 
current line. Part (string 1) of the command identifies the portion 
of the current line to be replaced; part (string 2) specifies the 
new data to be entered. Both string 1 and string 2 may contain any 
number of characters, including none. 


Null strings to be replaced or entered are indicated by two consec- 


utive separators such as //. 


If the number of characters in the current line, including the termi- 


nator, exceeds 135 as the result of a CHANGE command, the message: 


10 


TRUNCATED 


is printed at the console and the excessive right-hand characters 


(those exceeding 135, 9) of the current line are discarded. 


When the VERIFY Mode is ON, the altered line is automatically printed 
at the console on completion of the CHANGE operation. 


Edit Mode Commands 


Example: 
EDITOR X¥N Yrs 
oe EXAMP SRC OPEN demonstration program 
LT 
>P 4 PRINT four lines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATO 
TAG! AAA LINE 1 . fire teres 
BBB lines of 
oT TOP current ftle 
>L TAG LOCATE line containing "TAG" 
TAG) AAA /LINE 1 
>CHANGE /TAG/ADD/ CHANGE "TAG" to "ADD" tn current ltne 
ae AAA /LINE J vertfieation printout 
> 
ok 7 LOCATE ltne containing ".?" oe 
eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR 
>C /TOR/TION/ CHANGE command as, 
é eTITLE EXAMP 7EDIT COMMAND DEMONSTRATION changed line 
> 
>L BBB LOCATE line "BBB" a 
BBB 
>C //TAGB/ add "TAGB" to line using CHANGE command 
TAGB BBB 
>T 
>P 4 
elTITLE EXAMP 7EDIT COMMAND DEMONSTRATION first three 
ADDI AAA /LINE 1 lines of modifted 
TAGB BBB file oy 
>T TOP 
>L TAGB LOCATE line containing "TAGB" 
TAGB BBR 
>C ERO ts use null string to delete "TAGB" 
> 
4.5.8 OVERLAY [0] Command ae. 
Form: 
OVERLAY, 4n ) where n is a decimal number. 
NOTE i 
This command may be abbreviated as O 
{erqe; Ons). 
Description: 


This command enables the user to replace one or more lines input from 
the keyboard in place of the deleted material. The number of lines 
to be deleted in an OVERLAY operation is specified by the value as- 
signed to n. If n is omitted from the command, 1 is assumed. When 
an OVERLAY command is issued, the indicated lines are deleted and the 


operating mode is changed from EDIT to INPUT. 
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The user may then enter any number of lines as replacements. The 


INPUT mode is terminated and the EDIT mode restored by the entry of 
a null line (i.e., a line containing only a). 


Example: 


The following illustrates how the OVERLAY command is used to replace 
one line with two lines input from the console keyboard. 


EDITOR XYN Viresnmruy 


>OPEN EXAMP SRC OPEN demonstrator program 

EDIT 

>P 5 PRINT ftve tines 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR . ; 

TAG] AAA /LINE } first four lines 
RBB of current file 
ccc 

>T 

>L ccc LOCATE line "ccc" 
ccc 

>OVERLAY OVERLAY line "ccc" 

INPUT INPUT mode tdenttfter . 

THIS INPUT LINE IS TO REPLACE COVERLAY) LINE CCC keyed tn 

THIS LINE IS TO BE INSERTED BETWEEN NEW LINE AND TAG2 lines 

EDIT restore EDIT mode 

>T 

>P 8 
eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR first stz lines 

TAG) oa /LINE 1 of current file 


showtng the 


THIS INPUT LINE IS TO REPLACE (OVERLAY) LINE CCC Preae qian bape 


THIS LINE IS TO BE INSERTED BETWEEN NEW LINE AND TAG2 
TAG2 DDD /LINE 4 
EEE 


> 


4.5.9 APPEND [A] Command 


Form: 
APPEND, ,string) 
NOTE 
This command may be abbreviated as A 
(e.g., Auustring_/). 
Description: 


The APPEND command enables the user to add (append) data after the 
last character but before the line terminator of the current line 


and may contain any character. 
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Example: 
The following illustrates the use of the APPEND command: 


EDITOR X¥NO Yin 


>OPEN EXAMP SRC OPEN demonstrator program 
EDIT 
>P 6 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 7 é 
TAG! AAA /LINE 1 first ftve 
BBB lines of 
ccc current ftle 
fier DDD /LINE 4 
> 
>L RRR LOCATE line "BBB" 
RBB 
>APPEND /LINE 2 add " tab /LINE 2" to current Line 
>N 
>P 
CCC 
>A /LINE 3 add " tab /LINE 3" to current ltne 
>T 
>P 6 
eTITLE EXAMP EDIT COMMAND DEMONSTRATOR 
TAG] AAA 7LINE } 
BBB /LINE 2 printout of ftrst 
ccc /LINE 3 five ftle ltnes 
TAG2 DDD /LINE 4 showing added 
> matertal 
4.5.10 MOVE Command 
Form: 
MOVE, _,n,_ string) where n is a decimal number 
Description: 


The MOVE command enables the user to move the current line or n lines 
including the current line from their position in the file or buffer 
to a position immediately above (preceding) the file/buffer line 

which begins with "String". Any desired decimal value may be assigned 


to n; it may not be omitted from the command. 


If the value of n is too large, an END OF FILE REACHED message is given 


but nothing is moved from its original position. 
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The string specified should be the first characters of the line; where 
spaces and tabs are used as field delimiters, they must be entered as 
part of the identifying string (as in the FIND command). 


Example: 
The following example illustrates the use of the MOVE command. 


EDITOR *VHo Viewemmnm 

>OPEN EXAMP SRC OPEN demonstrator program 

EDIT 

>P 6 
elTITLE EXAMP ZEDIT COMMAND DEMONSTRATOR printout of 

TAG] AAA /LINE 1} first ftve 
BBB /LINE 2 file ltnes 
CCC /LINE 3 

= DDD /LINE 4 

> 

>L TAG LOCATE line contatning "TAG" 

TAG! AAA /LINE 1 current (LOCATEd) ltne 

>MOVE 1 TAG2 MOVE current line to posttton above line TAG2 

>T 

>P 6 


eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR printout of 


BRB /LINE 2 first five file 
ccc /LINE 3 lines; note 
TAGI AAA /LINE 1 moved line 
TAG2 DDD /LINE 4 


During a BLOCK ON state: 


a) If the number of lines specified in the MOVE command exceeds 
or equals the size of the current block buffer, the Editor 


outputs the message: 


SIZE TOO SMALL 
on the console printer and waits for the next user entry. 
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Example: 


+P 
EDITOR Vio Vresmmr 
>OPEN EXAMP SRC 
EDIT 
>BLOCK ON 
>S 5 
>READ 
>L TAG! 
TAG] AAA /LINE 1} 
>MOVE 1@ TAG2 
SIZE TO SMALL 
>Pp 
TAG! AAA /LINE } note, 


> 


b) If the MOVE command specifies more lines to be than 
are in the block buffer, the Editor outputs the error 


message: 
NOT ENOUGH LINES 


current line ts unchanged 


on the console printer and waits for the next user entry. 


NOTE 


Neither of the above error conditions changes 
the position of the current line pointer or 
affects the contents of the block buffer. 


During a BLOCK MODE OFF state: 


If the MOVE command specifies more lines to be moved than exist 


in the current file, EDIT outputs the error message: 


NOT ENOUGH LINES 


END OF FILE REACHED BY: 
(MOVE command entered) 


on the console printer and waits for the next user entry. 


Example: 


tP 

E D ] iT: 0 R x 7 " ‘J rir rey Mm 
>OPEN EXAMP SRC 
EDIT 

>L BBB 

BBB /LINE 2 

>MOVE 15 TAG3 

NOT ENOUGH LINES 

END OF FILE REACHED BYs 
MOVE 15 TAG3 


> 
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If there is not enough buffer space to store the lines being moved, 
the Editor outputs the message: 


NOT ENOUGH BUFFER SPACE 


at the console printer and waits for the next user entry. Neither of 
the above conditions affects the lines specified in the MOVE command; 
however, in an "END OF FILE" error condition, the current line 
pointer is moved past the last line in the file and there will be no 
current line. The user must then enter a TOP command and specify 
another line with a locative command. 


Whenever a "NOT ENOUGH BUFFER SPACE" error occurs, the current line 
becomes the line which caused the overflow condition. If the line 
containing the string specified in the MOVE command is not found, 


EDIT outputs the error message: 


LINES MOYED TQ. END 
BUFFER 
END OF FILE REACHED BY: 
MOVE, ,n,_,String 


and waits for the next user entry. 


When an error of this type occurs, the lines to be moved are deleted 
from their original positions ‘in the file and are placed at the end 

of the file. The lines are not lost but it is difficult to recover 
from this condition, care should be taken in entering the MOVE command 
to prevent this error from occurring. 


Example: 

In the following example, line TAG1 was erroneously moved to below 
the last line of the file when it was to be placed after the 
.TITLE line. 


The user recovered from this error by utilizing the MOVE command to 
move the 9 lines between .TITLE and TAG1 lines to a false posi- 

tion identified by string 22Z. The command results in the specified 
9 lines being moved below the last line of the file (i.e., TAG1) 


thus correctly positioning all lines of the file. 


Edit Mode Commands 


EDITOR #¥No Vroxririny 
>OPEN EXAMP SRC 
EDIT 
>L TAG! 
TAG] AAA /LINE 1 


>MOVE ! BRR bad command; tab before "BBB" not tneluded 


LINES MOVED TO END 
END OF FILE REACHED BYs resulting error message 
MOVE ! BBB 


>T 
>P 12 
ee EX AMP 7EDIT COMMAND DEMONSTRATOR 
ccc 
TAG2 DDD /LINE 4 
EEE 
FFF 
TAGS GGG /LINE 7 
HHH 
II! 
o END 
a AAA /LINE 1 resulting posttton of line "TAGL" 
> 
>L BBB 
BBB 
>MOVE 9 722 MOVE ltnes "BBB" through ".END" to 
LINES MOVED TO END © end of ftle, t.e., below line "TAGL" 
END OF FILE REACHED BY: 
MOVE 9 222 
>T 
>P 12 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE 1 
BBB 
ccc re 
TAG2 DDD /LINE 4 petneout oF 
EFF resulting ftle 
FFF 
TAG3 GGG /LINE 7 
HHH 
TUL 
e END 


NOTE 


The above recovery procedure is acceptable for short 
files; however, when editing long files it is more 
realistic to enter a CTRL P (Editor restart) and to 
reopen the file. A CTRL P entered during the pro- 
cessing of the MOVE command is ignored. After the 
MOVE has been processed then a new CTRL P will be 
honored. 


4.5.11 CONVERT Command 


Form: 
CONVERT,_,/string 1/string 2/,) 


NOTE 


The use of the last separator (/) is optional. 
Any character not in stringl or string2 may 
be used as a delimiter. 
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Description: 
The CONVERT command enables the user to change a specific item 


which is repeated throughout a file using only one command. 
This command scans the entire buffer or file and each time that it 


finds a string which matches string 1 it replaces that string with 
string 2 (as if a CHANGE command had been executed). 


If a string 2 is not given in the CONVERT command, all strings match- 
ing string 1 are deleted from the buffer or file. On completion of 

a CONVERT command, the current line pointer points to the first line 
below the last line in the file or buffer, as if an End Of File/ 


Buffer condition had occurred. 


If, during the convert process, a line exceeds 13549 characters 
including the terminator, it is truncated and the Editor outputs: 


(truncated line) 
TRUNCATED 


and the convert process continues. 
String 1 must be non-null, otherwise the message: 
NO STRING 
is output and the Editor waits for the next user command. 


The following example illustrates the use of the CONVERT command. 


EDITOR XVM VNXNNN 
>OPEN EXAMP SRC 


EDIT 

>P 12 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 

TAG! AAA /LINE 1 
BBB 
ccc 

TAG2 DDD /LINE 4 
EEE 
FFF 

TAGS GGG /LINE 7 a8 
HHH original 
III file 
e END 


Edit Mode Commands 


>T 
>CONVERT /TAG/ADD/ 
>T 
>P 12 
eTITLE EXAMP 7EDIT COMMAND DEMONSTRATOR 
ADD! AAA /LINE 1 
RBBB 
ccc 
ADD2 DDN /LINE 4 converted 
EEE file 
FFF 
ADD3 GGG /LINE 7 
HHH 
Ir! 
e END 


> 


If string 1 is never found, then the message 


NOT FOUND 


is output and the Editor waits for the next user command. 


4.5.12 LC (Line Convert) Command 


Form: 
LC, py, /string l1/string 2/) 
NOTE 
The use of the last separator (/) in the com- 
mand is optional. Any character not in string 1 
or string 2 may be used as a delimiter in this 
command. 
Description: 


This command performs the same type of operation as the CONVERT com- 
mand (see 4.5.11); however, it enables the user to specify the 


number (n) of lines to be scanned during the convert operation. 


The value assigned n indicates the number of lines to be scanned, 
including the current line. The last line scanned is printed and is 
made the current line. The value n cannot be omitted from the com- 


mand. 
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If the end of the file/buffer is reached by the LC command, the 
message: 


FILE 
END OF oe REACHED BY 
LC /STRING1 (Note command line starting with 


second separator is not typed) 


is typed on the console. 


EDITOR #VN Vscrumimi 
>OPEN EXAMP SRC 
EDIT 
>P 12 
eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR 
TAGI AAA /LINE 1 
BBB 
ccc 
TAG2 DDD /LINE 4 ae 
EEE ortginal 
FFF file 
TAG3 GGG /LINE 7 
HHH 
III 
END 
>T 
>LC 5 /TAG/ADD Line Convert command ; 
ADD2 DDD /LINE 4 current line after convert operation 
>T 
>P 12 
eTITLE EXAMP /EDIT. COMMAND DEMONSTRATOR 
ADD 1 AAA /LINE ! converted line 
BBB 
ccc 
ADD2 DDD /LINE 4 sanverted 
EEE file 
FFF 
TAGS GGG /LINE 7 
HHH 
Ill 
o END 
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4.5.13 MODIFY [M] Command 


Form: 
MODIFY, string) or ALT MODE 
NOTE 
This command may be abbreviated as M 
(e.g., MeuATE,/or ALT MODE). 
Description: ~ 


This command causes the contents of the current line up to the last 
character of the specified string to be printed at the console. The ™ 
user may then add characters to the current line via the console key- 


board. The input operation may be terminated with either: 


a) an ALT MODE which specifies that the remainder (unprinted 
portion) of the original line is to be added to the modified 
line; 

b) a CARRIAGE RETURN (J) which specifies that the unprinted _ 
portion of the original line is to be deleted. 


A line may contain a maximum of 13549 characters (including termina- 
tor); when this limit is reached during a MODIFY operation, the 

Editor issues a CARRIAGE RETURN and waits for the next user command. 
Care must be taken to ensure that the final line does not exceed 135, 9 
characters since characters above this limit are dropped from the 


final line. 


NOTE 


The RUBOUT and CTRL U commands may be used for data 
keyed in during MODIFY operations; however, they 
will not affect the contents of the original line. 


CTRL P should not be used during MODIFY operations; 
if the user wishes to go back to the original line, 
CTRL U should be entered to delete any new data 

and the operation terminated by ALT MODE to restore 
the original line. 
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Example: 
EDITOR KVM Venn 
>OPEN EXAMP SRC OPEN demonstrator program 
EDIT 
>P 12 
eTITLE EXAMP /EDIT COMMAND DEMONSTRATOR 
TAG! AAA /LINE 1 
BBB 
ccc 
TAG2 DDD /LINE 4 
EEE 
FFF oe eer 
TAG3 6GG /LINE 7 o ig 
HHH file 
II! 
» END 
>T 
>L TAG2 
TAG2 DDD /LINE 4 
>MODIFY DDD MODIFY command ee ; 
TAG2 DDD NEW DATA WITH RETURN TERMINATOR modified line 
>P ae ee: NeW data 
TAG2 DDD NEW DATA WITH RETURN TERMINATOR ‘ew form of line TAG2 
>L TAG3 
TAG3 GGG /LINE 7 
>MODIFY GGG . oa 
TAGS GGG NEW DATA WITH ALT MODE TERMINATOR ALINE 7 oi at 
>P new data une 
TAG3 GGG NEW DATA WITH ALT MODE TERMINATOR /LINE 7 new form 
>B 
eEND 
>CLOSE 


EDITOR xVM Vrixnimn 


> 
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4.6 EDIT CLOSE OPERATION COMMANDS 
The EDIT Mode commands which are used to terminate EDIT operations and 
to write the edited program onto the final output device are described 
in paragraphs 4.6.1 through 4.6.4. 
4.6.1 CLOSE Command 
Form: 

CLOSE uf ilenamewuextension ~ 
Description: —~ 
If an input file is present, the current line and all lines in that ms 
file falling below the current line are appended to the output file, 
and the output file is closed. If no input file is present, the 
current line is added to the output file, and the output file is 


closed. No further editing is permitted. 


If the extension is omitted, it is assumed to be SRC. If no file 


name is given, the name assigned in the OPEN command line is used. 


Neither file name nor ext need be given for a non-directoried output 
device. 


4.6.2 PCLOSE Command 
Form: 

PCLOSE «/ 
Description: 


Closes the output file opened by PUT. A PCLOSE will be simulated by 


the following commands: 


TOP 
CLOSE 
SCLOSE 
EXIT 


Edit Mode Commands 

After any of the above commands, the entire file from the current line 
at the time to the last line of the file (inclusive) will also be 
placed in the PUT file. After the last line is copied the PUT file 
will be closed. If PCLOSE is used to close the PUT file, the current 
line is not included in the PUT file. 
4.6.3 SCLOSE Command 
Form: 

SCLOSE «/ 
Description: 
This command permits the placement of a file onto the current output 
device. It is particularly useful in closing long files which have 
only minor changes since the .DAT -15 to .DAT -14 recopying will not 


take place if .DAT -15 is the current output device. 


4.6.4 EXIT [E] Command 


Form: 
EXITwufilenamersext ./ 
NOTE 
This command may be abbreviated as E 
le.g., Ee’) 
Description: 


The EXIT command performs the same operations as the CLOSE command 
except that control is returned to the Monitor after the file is 
closed instead of to the EDITOR. 


Example: 


EDITOR XVM Vnxnnn 
>OPEN FILEA SRC 
EDIT 

>B 

BBBB 

>EXIT 


XVM/DOS Vnxnnn 
$ 


COMMAND ABBREVIATION 
APPEND A 
ON 
sxocK Neh none 
BOTTOM B 
ON 
parse} | none 
CHANGE 12: 
CLOSE none 
CONVERT none 
DELETE D 
EXIT none 
FIND F 
GET G 
INSERT ne 
INSERT string I 
KEEP K 
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SUMMARY OF EDITING COMMANDS 


OPERATION 


Add string at the rightmost end 
of the current line. 


Set program to operate in block 
mode (ON) or in line-by-line 
mode (OFF). 


Make last line of file/buffer 
the current line. 


Set brief mode to print trun- 
cated (ON) or full (OFF) lines. 


Replace, in the current line, 
the first occurrence of stringl 
with string2. 


Terminate editing on input file 
and return to the Editor. 


Change all occurrences of stringl 
within the file/buffer to string2. 


Delete the current n lines. 


Close the output file and trans- 
fer control to Monitor. 


Make the first line beginning 
with string the current line. 


Add lines from subsidiary input 
device after (below) the current 
line. 


Change mode to input. 

Add string, as a complete line, 

to the file after (below) the 
current line. 

Keep (i.e., preserve) the original 


file (on .DAT -14) for backup 
purposes. 
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PARAGRAPH 
REFERENCE 


4.2.10 


Summary of Editing Commands 


PARAGRAPH 


COMMAND ABBREVIATION OPERATION REFERENCE 


LC LC Same as CONVERT command except 4.5.12 
(Line Convert) that the number of lines to be 

converted is specified in the 

command. 


LIST none Print the current line on the 4.5.2 
listing device. 


LOCATE L Make the first line containing 4.4.5 
string the current line. 


MODIFY none Search the current line for a 4.5.13 
specified text string; when it 
is found, accept new inputs 
from the keyboard and append 
them to the line starting after 
the last character of the given 
text string. 


MOVE none Move a specified number of lines 4.5.10 
including the current line, to 
a position in the file/buffer 
immediately before (above) a 
line identified by a given string. 


NEXT N Skip the next n consecutive lines 4.4.2 
to the new current line. 

OPEN none Prepare file on input device for 4.2.3 
editing. 

OUTPUT none Output selected portions of file. 4.2.9 

OVERLAY O Replace multiple lines. 4.5.8 

PARITY pes none Set parity checking to ON or 4.2.11 

OFF 

OFF. 

PCLOSE none Closes the output file opened 4.6.2 
by PUT. 

PRINT P Print the current n lines on 4.5.1 
the console device. 

PUT none Place portions of a file into 4.2.4 
many separate source files. 

READ none Fill block buffer from input file. 4.3.1 

RENEW none Perform buffer WRITE/READ func- 4.3.3 
tions. 

RETYPE R Replace current line with string. 4.5.4 

SCLOSE none Close file and leave on current 4.6.3 


output device. 


SIZE s Set total number of lines in A236 
block buffer. 
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Summary of Editing Commands 


PARAGRAPH 
COMMAND ABBREVIATION OPERATION REFERENCE 
TOP T Reset current line pointer to 4.4.1 
beginning of file or buffer. 
TV ‘a Enables/Disable soft display Appen- 
when using EDITVP/EDITVT XVM. dices 
Bé&C 
ON Set VERIFY mode to print (ON) 442.7 
VERTES Ee ¥ or ignore printing (OFF) lines 
after processing CHANGE, LOCATE, 
and FIND requests. 
WRITE none Add block buffer to output file. 4.3.2 
SPECIAL COMMANDS 
INPUT Delete named file from input or 4.2.2 
ete EEO eae output device. (No abbreviation.) 
INPUT Rename named file located on 4.2.1 
ce See aS specified input or output de- 
vice. (No abbreviation.) 
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EDITVP 


In XVM/DOS systems which have a VP15A Storage Tube Display Unit and 
the device handler (VPA) in their hardware configuration, the user can 
call program EDITVP for use in editing operations in place of EDIT. 
The program EDITVP permits the storage tube to be used as a display 
device during editing operations. All standard editing commands (as 
described in Section 4) may be used in EDITVP operations with the 
following addition: 

ov {ou 
This command enables or disables the display according to the ON/OFF 
parameter. The command may be given at any time. Typing TV ON im- 
plies VERIFY OFF (no Teletype output); however, typing TV OFF does 
not automatically set VERIFY ON. When EDITVP is first loaded, TV is 
OFF. If, at the top of a file or BLOCK (i.e., OPEN or TOP was just 
typed), TV ON is typed, a Locative Request (e.g., NEXT, FIND, LOCATE, 
etc.) must be given before any lines are displayed. If TV ON is typed 
after the execution of a Locative Request, a group of lines most re- 
cently added to the output file or block will be displayed - with the 


current line (to which modifications apply) appearing as the last line. 


EDITVP uses the same .DAT slot assignments as the Editor with the ad- 
dition of .DAT slot 10 which must be assigned to VPA (via the ASSIGN 
command). EDITVP is supplied as a system program and is requested by 
the following XVM/DOS command: 


SEDITVP «/ 


During EDITVP editing operations, if any part of the current line is 
modified (as with RETYPE, CHANGE, OVERLAY or DELETE commands) a dashed 
line is drawn through the displayed line containing the change and the 
modified line is displayed below it. When a section of text which has 
been modified as described above is re-displayed (after a TOP command) 


the crossed-out line is eliminated. 
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EDITVP 


DISPLAY CONTROLS 


The VP15A display unit is provided with two pushbutton controls, ERASE 
and VIEW, which are located on the right front panel of the CRT enclo- 
sure. These controls are used in the following manner: 


a) ERASE when operated, it causes the current dis- 
play to be erased from the display. 


b) VIEW The normal brightness of displayed data 
fades after 90 seconds unless renewed; 
this control enables the user to renew 
(brighten) the display when desired. ~ 


WARNING eat 


The same display should not be maintained 

on the CRT for a period exceeding 15 minutes; 
if this occurs, the phosphor of the display 
CRT may be damaged. 


DISPLAY MODES 


The VPI5A CRT is capable of displaying 56, 72-character lines. If — 
the data file to be displayed exceeds the 56-line display capacity, 

the display will operate in either a SCAN or PAGE mode, depending on 

the type of handler installed in the system (VPA or VPA.S) for the 

VP15a.? 


SCAN Mode 


When the VPA device handler is installed in the operating system, the 
VP15A display operates in a SCAN mode. In this mode, each time the 
display screen is filled it is erased automatically after the Be 
line is written and is refilled from the display file. This fill- 
erase-rewrite cycle is continued until the screen is completely or 
partially filled and no more data is in the file to be displayed. The 
last display is not erased but remains and may be renewed (brightened) 


manually by the viewer when necessary. 


IThe type of VP15A handler available in the XVM/DOS operating system 
will be that selected by the System Manager during the configuration 
of the system. 


EDITVP 
PAGE Mode 


When the VPA.S handler is installed in the operating system, the VPI15A 
display operates in a PAGE mode. In this mode, the erase-rewrite op- 
erations of the display are controlled by the settings of the unit 
ERASE control and the computer console switch ACS@. With the ERASE 
and ACS@ controls set, each time the display is filled (i.e., full 
page) the display is not automatically erased and the next set of data 
displayed. This operation is not performed until the ERASE control 

is actuated by the user. This feature permits the user to manually 
advance through a file being edited, page by page. 


EDITING OPERATIONS 


The following notes describe some of the features of EDITVP and the 
manner in which it performs some of the basic editing functions. 


a) Announcements, error messages and ">" symbols are 
echoed on the console printer. 


b) Locative operations, the file lines passed over 
during locative operations are displayed as the 
file is scanned. The last line displayed is al- 
ways the current line (found line). 


c) CONVERT and LC command operations. Only those 
lines changed in a file as the result of the com- 
mand are displayed. 


d) GET Command. The data to be added to a file from 
the subsidiary device is displayed on the screen 
as it is added to the current file or buffer. 


e) DELETE Command. On the execution of a DELETE com- 
mand, dashed lines are drawn through deleted items. 


f) PRINT Command. The PRINT command implies "hard 
copy"; the line(s) selected by the command are 
output on the console printer. The current line 
is always the last line displayed. 


g) Clear Screen Commands. The display screen is 
cleared by the entry of any of the following com- 


mands: 
1) TOP 
2) CLOSE 
3) EXIT 
4) TV OFF 
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EDITVT 


DOS systems which have a VT15 Graphics Display unit permit the user to 
employ program EDITVT for editing purposes. Program EDITVT enables 
the user to perform soft-copy editing of files using the VT15 display 
as a file data display device. Data is displayed in sets of either 56, 
72-character lines or 28, 72-character lines. The EDITVT commands and 
the editing functions performed are essentially the same as those of 
the standard Editor Program (EDIT). 


SETUP COMMANDS 


The following command must be issued to the monitor prior to loading 
EDITVT: 


a) $VT ON Enables the VT display unit. 


b) S$HALF ON/OFF This command is optional; it enables the 
user to set up a half-screen display 
(i.e., 28, 72-character lines) condition 
in which only half the screen is used for 
display. 


c) $tx (control X) Turn on VT display unit. 


The program EDITVT is loaded into core by the command EDITVT given to 
the monitor. Once loaded, the program will announce itself by output- 
ting its name and version number on the console printer. The user must 
then input the command TV ON to initiate the VT15 display operations. 


VT15 display operations may be stopped at any time by the command TV 
OFF. 


EDITVT 
VT15 CONTROLS AND DISPLAY MODES 


CONTROLS 


The VIT15 Display console contains a horizontal strip of six square 
push-to-light pushbuttons which are used in display operations. 
These pushbuttons are unmarked since their function is determined by 
software and may vary according to the particular program (system or 
user) which is in control of the system. 


In EDIT operations, only the two rightmost pushbuttons are needed; 
these switches are referred to as numbers 5 and 6, based on the fol- 


lowing numbering scheme: 


Yo ow & 





DISPLAY MODES 


The VT15 Display operates in two display modes: 


a) SCROLL Mode - When the number 5 pushbutton is in the 
OFF (unlit) position, the display is in 
the SCROLL mode. In this mode, when 
the display screen is full, the next 
line of data to be displayed causes the 
displayed material to "roll" upwards, 
line-by-line, with new data displayed 
at the bottom of the screen. 


b) PAGE Mode - When the number 5 pushbutton is in the 
ON (lit) position, the display is in 
the PAGE mode. In this mode, when the 
screen is full, the next entered material 
for display causes the complete, full- 
screen display (i.e., PAGE) to be erased; 
the new material is then displayed start- 
ing at the top line of the screen. When 
a large file is to be displayed in the 
PAGE mode, the number 6 control push- 
button is used to advance the display 
through the file page (screen) by page 
(screen). Each time this pushbutton is 
actuated, the screen is cleared and the 
next set of data available is displayed. 


WARNING 


The EDITOR may appear hung when number 5 
is ON (lit) and the page is full (i.e., 
waiting for change in state of number 6). 


a 


EDITVT 


EDITING OPERATIONS 


The following notes describe some of the features of EDITVT and the 


manner in which it performs some of the basic editing functions. 


a) 


b) 


c) 


d) 


e) 


£) 


g) 


Announcements, error messages and ">" symbols are 
echoed on the console printer. 


Locative operations, the file lines passed over 
during locative operations are displayed as the 
file is scanned. The last line displayed is al- 
ways the current line (found line). 


CONVERT and LC command operations. Only those 
lines changed in a file as the result of the com- 
mand are displayed. 


GET Command. The data to be added to a file from 
the subsidiary device is displayed on the screen 
as it is added to the current file or buffer. 


DELETE Command. On the execution of a DELETE com- 
mand, the line(s) affected are erased from the 
screen and the remainder of the file is rolled up 
to fill the deleted (erased) line(s). 


PRINT Command. The PRINT command implies "hard 
copy"; the line(s) selected by the command are 
output on the console printer. The current line 
is always the last line displayed. 


Clear Screen Commands. The display screen is cleared 
by the entry of any of the following commands: 


1) TOP 

2) CLOSE 
3) EXIT 
4) TV OFF 


5) Change the state of #6 pushbutton and 
the screen will clear when the next 
output is made to the VT15 (e.g., new 
line added, mode change). 


Abbreviated commands, 4-1 
Add data, 4-31 
APPEND command, 4-31 
GET command, 4-16 
ALT MODE, 3-2, 4-40 
APPEND command, 4-31 
ASSIGN command, 2-4 
@ (at symbol) usage, 2-7 


Blanks in commands, 4-1 
Block mode, 2-1, 2-2 
buffer overflow, 3-6 
edit, 3-3 
BLOCK OFF command, 3-3, 4-5 
BLOCK ON command, 3-3, 4-5, 4-8 
BOTTOM command, 4-20 
Brackets [ ] used as symbol for 
optional command string ele- 
ments, 1-2 
BRIEF command, 4-9 
Brightening, B-2 
Buffer, 
overflow in block mode, 3-6 
search, 2-2 
size, 4-5, 4-7 
space, 4-35 


CALL DELETE command, 4- 

CALL RENAME command, 4- 

Calling errors, 3-6 

Carriage RETURN, 3-2 

Carriage RETURN-LINE FEED symbol 
(4/), 1-2 

CHANGE command, 4-29 

Change items in file, 4-37 

Character deletion, 2-6 

Checksum, 3=5 

Clear screen commands, B-3, C-3 

CLOSE command, 3-2, 3-3, 4-43, 
B-3, C=-3 

Closing the new file, 3-3 

Command abbreviation, 4-1 

Command mode, 2-1 

Command string errors, 3-4 


3 
2 


INDEX 


Commands, 
clear screen, B-3, C-3 
edit close operation, 4-43 
input/output, 4-13 
line pointer control, 4-17 


Index-1 


locative, 4 


manipulative, 


=L7 


4-22 


text modification, 4-22 
Commands, 


APPEND, 4-3 
BLOCK OFF, 

BLOCK ON, 3 
BOTTOM, 4-2 
BRIEF, 4-9 

CALL DELETE 
CALL RENAME 
CHANGE, 4-2 
CLOSE, 3-2, 
CONVERT, 4- 


1 
39, 2 
~3, 
0 

. 3 

, on2 

9 

4-3, 

36, Be 


-5 
5, 4-8 


4-43, B-3, C-3 


3, ¢€-3 


DELETE, 4~25, B~-3, C-3 


EDITVP, B-1 
EDITVT, C-1 


EXIT, 4-44, B-3, C-3 


FIND, 4-20 
GET, 4-16, 
SHALF ON/OF 
INSERT, 3-2 
INSERT stri 
KEEP, 4-12 


B-3, C 
Ey Cal 
, 4-27 


<3 


ng, 4-28 


LC (Line Convert), 4-38, 


c-3 
LIST, 4-24 
LOCATE, 4-2 
MODIFY, 4-4 
MOVE, 4-32 
NEXT, 4-18 
OPEN, 3-1, 
OUTPUT, 4-1 
OVERLAY, 4- 
PARITY, 4-1 
PCLOSE, 4-4 
PRINT, 4-22 
PpuT, 4-5 
READ, 4-14 
RENEW, 4-6, 
RETYPE, 4-2 
SCLOSE, 4-4 
SIZE, 3-3, 


i. 
0 


3-3, 4-4 


0 

30 

3 

3 

’ B-3, 


4-15 
6 
4 
4-7 


C=3 


B-3, 


INDEX (Cont.) 


Commands (cont.), 
summary, A-1 
TOP, 4-18, B-3, 
TV ON/OFF, B-l, 
VERIFY, 4-8 
SVT ON, C-1 
WRITE, 3-3, 
$t+X, C-l 

Control modes, 2-1, 3-2, 

CONVERT command, 4-36, B-3, C-3 

Creating a new file, 3-2 

CTRL P keyboard command, 

4-40 

CTRL U, 


4-15 


2-6, 


5-7, #40 


Dashed line on display unit, B-1l 

Data files, 2-3 

Data modes, 2-1 

DAT slot .assignments, 

DELETE command, 4-25, 

Deletion of 
characters, 
line, 2-7 


2-4, 
B-3, 


2-6 


Device assignment table (.DAT), 2-4 


Directoried device, 2-4 
Display controls, VP15A, B-2 
Display modes, 

VP15A, B-2 

VT15, C-2 


Duplicate file names, 3-7 


Edit block mode, 3-3 
Edit close operation commands, 
4-43 
Edit mode, 2-1, 3-2 
Edit mode commands, 
EDITVP, B-l 
EDITVT, C-l 
End-of-file, 
Erase 
characters, 2-6 
line of typing, 2-7 
ERASE push button, B-2, B-3 
Error-handling conventions, 3-4 
Example file, 4-2 


4-1 


premature, 3-4 


EXIT command, 4-44, B-3, C-3 
File, 
closing, 3-3, 4-43, 4-44 
creation, 3-2 
deletion, 3-8, 4-3 


B-2, C= 


File (cont.), 
example, 4-2 
modification, 3-1 
naming errors, 3-6 
opening, 4-4 
renaming, 3-8, 4-2 
saving, 4-12 


Filename ext, 3-1 


2 Filenames, duplicate, 3-7 
Files, 
input, 2-4 
subsidiary, 2-4 
FIND command, 4-20 
GET command, 4-16, B-3, C-3 


SHALF ON/OFF command, C-1 


INPUT control mode, 2-1 
Input files, 2-4 

Input line truncation, 3-6 
INPUT mode, 3-2 


Input/output commands, 4-13 
Input/foutput, monitor, 2-3 
INSERT command, 3-2, 4-27 
INSERT line command, 4-28 


KEEP command, 4-12 


LC (Line Convert) command, 
B-3, C-3 
Line, 
deletion, 
insertion, 
modification, 
overflow, 3-5 
processing, 2-3 
replacement, 4-26, 4-30 
Line-by-line data mode, 2-1 
Line-by-line search, 4-20 
Line pointer, 2-1, 4-15 
control commands, 4-17 
Line printer, Unichannel, 
LIST command, 4-24 
LOCATE command, 4-21 
Locative commands, 4-17 


4-38, 


9-9, §-25 
4-27, 4-28 
4-40 


4-24 


Index-2 


Manipulative commands, 4-22 


Modes of operation, 2-1, 3 
4-5 
MODIFY command, 4-40 


Modifying an existing file, 


Monitor I/0, 2-3 
MOVE command, 4-32 


NEXT command, 4-18 
Nondirectoried device, 2-4 


OPEN command, 3-1, 3-3, 4- 
OUTPUT command, 4-10 
Output file conventions, 2 
Output files, 2-5 
Overflow, block mode buffe 
OVERLAY command, 4~=30 


Page mode, 

VP15A, B-3 

VT15, C-2 
Parity, 3-5 
PARITY command, 4-13 
PCLOSE command, 4-43 
Pointer, 

see Line pointer 
Premature end-of-file, 3-4 
PRINT command, 4-22, B-3, 
Push buttons, 

VP15A, B-3 

VT15, C-3 
PUT command, 4-5 


READ command, 4-14 

Read errors, 3-5 

RENEW command, 4-6, 4-15 
Replace current line 4-26 
Replace lines, 4-30 
Restart Editor, 2-6 

RETYPE command, 4-26 
RUBOUT, 2-6, 4-40 


Save current file, 4-12 
Scan mode, VP15A, B-2 
SCLOSE command, 4-44 
Scratch device, 2-5 
Scroll mode, VT15, C-2 


-2, 


a 
-6 


r, 


C-3 


INDEX 


3-1 


3-6 


(Cont.) 


Searching, 2-2, 4-21 
Setup commands, 4-2 
EDITVT, C-1l 
SIZE command, 3-3, 4-7 
Spaces in commands, 4-1 
Space symbol (uu), 1-2 
Storage tube display unit, VPI15A, 
B-1 
Subsidiary files, 2-4 
Summary editing commands, A-1 
Symbois used in this manual, 1-2 


Tab symbol (|), 1-2 
Terminate editor output, 2-7 
Text mode, 2-1 
Text modification, 2-2 
commands, 4-22 
TOP command, 4-18, B-3, C-3 
Truncation, 3-6, 4-29, 4-37, 4-40 
TV ON/OFF command, B-l, B-3, C-3 


UFDT slot assignments, 2-4 
Unichannel line printer, 4-24 


VERIFY command, 4-8 

Verify mode, 4-10 

VIEW push button, B-2 

VPL5A storage tube display unit, 
B-1 

VT15 controls and display modes, 
C-2 

VT15 graphics display unit, C-1 

SVT ON command, C-l 


WRITE command, 3-3, 4-15 


$+X command, C-1 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repert (SPR) form. 


Did you find errors in this manual? If so, specify by page. 














Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 








Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 

Higher-level language programmer 

Occasional programmer (experienced) 

User with little programming experience 

Student programmer 

Non-programmer interested in computer concepts and capabilities 
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Name Date 
Organization 
Street 
city State_.— CCC Zip Code 
or 
Country 


If you require a written reply, please check here. J 
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